home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / sidpl110.zip / SIDPLAY.DOC < prev    next >
Text File  |  1994-04-13  |  9KB  |  221 lines
  1.  
  2.       ╒════════════════════════════════════════════════════════════╕
  3.       │ SIDPLAY v1.10       Copyright (C) 1993,94 Michael Schwendt │
  4.       ╘════════════════════════════════════════════════════════════╛
  5.  
  6.  SIDPLAY emulates the Sound Interface Device (SID 6581) and the 6510 CPU
  7.  of the Commodore C64 on  the PC. Therefore it is  able to execute those
  8.  fragments of code which produce sound or music. The idea for SIDPLAY is
  9.  based on the Amiga product "The 100 most remembered C64 game-tunes" and
  10.  its updates by Håkan Sundell and Ron Birk.
  11.  
  12.  This piece of software is copyrighted. It may not be sold by anyone but
  13.  can be  copied freely by everybody as long as    the original package and
  14.  its contents have not been changed or modified in any other way. If you
  15.  have paid money for this you have been cheated.
  16.  
  17.  SIDPLAY is CARDWARE. That means, if you like this program you must send
  18.  me a postcard    so that I can see how    much SIDPLAY is  used around the
  19.  world. This also helps me getting motivated in programming upgrades and
  20.  further  productions. If  you have  any comments, bug  reports, help or
  21.  criticism feel  free to contact  me. You will  find my address  at  the
  22.  bottom of this text file.
  23.  
  24.  More than 500 different tunes  should be available in several packages.
  25.  These musics  from the  Commodore  64  are still  copyrighted  by their
  26.  original owners.  That is  the reason why  this program  is distributed
  27.  without any tunes (except the included demonstration sounds from Martin
  28.  Galway, Rob Hubbard and David Whittaker) though many of them are almost
  29.  10 years old by now, thus  spreading them is more likely  to perform as
  30.  advertising than causing any consequential damage.
  31.  
  32. ───────────────────────────────────────────────────────────────────────────────
  33.  
  34.  PACKAGE LIST:
  35.  
  36.  The original  self-extracting SIDPLAY archive  should only contain  the
  37.  following files:
  38.  
  39.    sidplay.exe        ; the main program
  40.    sidplay.doc        ; this text
  41.    sidplay.rev        ; revision history file
  42.    sidplay.faq        ; frequently asked questions
  43.    info2sid.exe        ; converts any .INF(O) files in the current
  44.                           directory to .SID format
  45.  
  46. ───────────────────────────────────────────────────────────────────────────────
  47.  
  48.  KEY FUNCTIONS (SELECTOR):
  49.  
  50.  Use the  CURSOR KEYS, PAGE UP/DOWN  and RETURN to select a .DAT file in
  51.  the selection window. ESCAPE quits the program back to DOS.
  52.  
  53.  
  54.  
  55.  KEY FUNCTIONS (SOUND CONTROL):
  56.  
  57.  CURSOR LEFT  - replay previous tune if possible
  58.  CURSOR RIGHT - replay next tune if possible
  59.  CURSOR UP    - enter four times faster replay, back to normal speed by
  60.                 pressing any other key
  61.  CURSOR DOWN  - enable two times faster replay, back to normal speed by
  62.         pressing any other key
  63.  ENTER        -    returns back to the selector
  64.  ESCAPE          -    quits back to DOS at any time
  65.  
  66.  Note: The fast forward mode starts/ends after a short delay which is
  67.        caused by technical problems.
  68.  
  69. ───────────────────────────────────────────────────────────────────────────────
  70.  
  71.  THE COMMAND LINE PARAMETERS:
  72.  
  73.  SIDPLAY provides  optional command  line parameters.  These can  be set
  74.  either to achieve better  sound quality,  faster key-interrupt handling
  75.  or to override the Soundblaster auto-detection.
  76.  
  77.  /f<Hz> sets the sample mixing frequency (i.e. sound quality)
  78.         where <Hz> is a frequency between 12000 and 45000 Hz
  79.  
  80.  /b<length> sets the amount of bytes to be processed till next interrupt
  81.         occurs (values between 1024 and 65530 possible);
  82.         a small buffer results in faster key-interrupt handling;
  83.         very useful for switching through plenty of sounds
  84.  
  85.  Use the following  parameters only if the  SB auto-detections fails and
  86.  if you haven't set the BLASTER environment variable.
  87.  
  88.  /p<port> where <port> is the base port address of the soundcard
  89.  /d<dma>  where <dma> is the DMA channel used by your SB
  90.  /i<irq>  where <irq> is the interrupt line used by your SB
  91.  
  92.  Example: SIDPLAY /p220 /i7 /d1     (=Soundblaster    factory settings)
  93.  
  94. ───────────────────────────────────────────────────────────────────────────────
  95.  
  96.  THE .SID DESCRIPTION-FILES:
  97.  
  98.  The data  files that  should be available  for this  utility or for the
  99.  similar Amiga    product are binary  code and  data files  that have been
  100.  transfered  directly from  the C64. Both the C64 and this emulator need
  101.  additional information  about the memory location, the  number of tunes
  102.  and/or  the  starting    address of the    executable  code. That    specific
  103.  information should be delivered in form of info files together with the
  104.  .DAT data files.  This utility  uses special .SID ASCII-text  files but
  105.  also handles the Amiga infos (.INF extension).
  106.  
  107.  
  108.  
  109.  THE .SID-FILE SYNTAX:
  110.  
  111.  The format of an EXAMPLE.SID description file should look like this:
  112.  
  113.   SIDPLAY INFOFILE
  114.   ADDRESS=2AF0,3002,300C
  115.   SONGS=3
  116.   SPEED=0
  117.   NAME=Example
  118.   AUTHOR=Example
  119.   COPYRIGHT=1993 Example
  120.  
  121.  The first line of text is only to identify the type of file (the .SID
  122.  extension may not be enough).
  123.  
  124.  ADDRESS=<loadaddress>,<initaddress>,<playaddress>
  125.  
  126.    <loadaddress> is the address to load the .DAT file at (0 means the file
  127.          is in original C64 format, i.e. the first two byte contain
  128.          the loadaddress (lo/hi).
  129.  
  130.    <initaddress> is the start address of a subroutine that initializes a
  131.                  sound using the 6510 accumulator as song number (0-255).
  132.  
  133.    <playaddress> is the start address of a subroutine that can be called
  134.                  frequently by interrupt to produce a continuous sound.
  135.  
  136.    Each address is a 16-bit hexadecimal effective C64 memory address.
  137.  
  138.  SONGS=<total>,[<start>]
  139.  
  140.    <total> is the decimal number of tunes/sounds that can be initialized
  141.        using the init-subroutine (minimum = 1).
  142.  
  143.    <start> default=1, is the decimal number of the tune to be played
  144.        automatically after selecting a .DAT file (lowest = 1).
  145.  
  146.  SPEED=<value>
  147.  
  148.    <value> is a hexadecimal number that contains information about the
  149.        speed of each tune/sound. For each tune/sound a bit is reserved,
  150.        bit 0 for tune 1, bit 1 for tune 2 and so on. A 0 bit means
  151.        the play-subroutine is called 50 Hz and a 1 bit means the speed
  152.        which is indicated by the CIA Timer A (DC04/05) (default 60 Hz)
  153.  
  154.    Examples: SPEED=0  replays every tune at 50 Hz
  155.          SPEED=1F replays tunes 1-5 (accumulator 0-4) at 60Hz
  156.               and tunes 6-8 (a 5-7) at 50 Hz
  157.  
  158.  
  159.  NAME=<name of music/tune>                ; ASCII
  160.  
  161.  AUTHOR=<name of author/composer>            ; ASCII
  162.  
  163.  COPYRIGHT=<year/name of copyright owner/company>    ; ASCII
  164.  
  165. ───────────────────────────────────────────────────────────────────────────────
  166.  
  167.  TECHNICAL INFORMATION:
  168.  
  169.  - emulation of valid and illegal 6502 instructions
  170.  - full realtime envelope and waveform calculation (except noise),
  171.  - emulation of carrier-modulator ring modulation and synchronize
  172.  - supporting CIA 6526 Timer-A interrupt
  173.  - allowing use of full 64K C64 host memory
  174.  - supporting fixed routines with C64 'volume samples' (Amiga player)
  175.  - supporting Pro AudioSpectrum, PAS Plus and PAS 16
  176.  - supporting Soundblaster or Soundblaster Pro compatible soundcards
  177.  - playing samples in 8-bit mode at 12000-44000 Hz
  178.  - 100% machine code
  179.  
  180.  
  181.  
  182.  FUTURE IMPROVEMENTS:
  183.  
  184.  - emulation of nondefined 6502 codes
  185.  - emulation of all C64 samples
  186.  - master volume support
  187.  - faster code + fixed bugs (more?)
  188.  
  189. ───────────────────────────────────────────────────────────────────────────────
  190.  
  191.  CONTACTING THE AUTHOR:
  192.  
  193.  via Internet e-mail:  3schwend@rzdspc5.informatik.uni-hamburg.de
  194.  
  195.  via normal mail:      Michael Schwendt
  196.                An der Wallpforte 1
  197.                23879 Moelln
  198.                GERMANY
  199.  
  200.  via telephone:           +49-(0)4542-7194 after 18:00 CET
  201.  
  202. ───────────────────────────────────────────────────────────────────────────────
  203.  
  204.                           Thanks must go to:
  205.                    Thorsten (for lending me his SB Pro)
  206.     Oliver and Michael (for spreading either the beta or release versions)
  207.         Brandon and Steven (for supplying me with SB docs)
  208.         Wolfgang "release it !!!" (for C64 docs)
  209.     Jens W. "it just won't work" (for the first SB Pro test)
  210.           Ingo and his SB 2.0 (for revealing a lame bug)
  211.                   Jens F. (also for spreading)
  212.        to all the people on Internet who also helped me collecting
  213.               Soundblaster related programming information
  214.          and to you for your moral support and the bug reports
  215.               on the previous versions (keep on!)
  216.  
  217.       Now you shouldn't read this file any longer. Start the player and
  218.                   enjoy the good old Commodore 64 sound !
  219.  
  220.                                -=-
  221.